home *** CD-ROM | disk | FTP | other *** search
/ SGI Networker 4.2.9 / Networker 4.2.9 for IRIX 6.2, 6.3 and 6.4.img / relnotes / networker / ch5.z / ch5
Text File  |  1997-07-08  |  33KB  |  727 lines

  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        5.  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  9.  
  10.        The problems in this chapter are listed in relative order of
  11.        importance, starting with the most important.
  12.  
  13.  
  14.        _N_o _I_n_c_i_d_e_n_t #
  15.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Be sure to look at SYSLOG and daemon.log for
  16.        important NetWorker messages.
  17.  
  18.        Many important NetWorker messages will be written to the
  19.        /usr/var/SYSLOG or to /nsr/logs/daemon.log files. It is
  20.        critically important that the system administrator watch
  21.        these logs closely to learn about errors or other problems
  22.        encountered by NetWorker.
  23.  
  24.        If you use the System Log Viewer, then choose Warning from
  25.        the Filter menu to display NetWorker root messages.
  26.  
  27.  
  28.        _I_n_c_i_d_e_n_t #_2_2_1_4_2_9
  29.        SSSSuuuummmmmmmmaaaarrrryyyy::::  If your licenses expire, configuration is
  30.        partially destroyed.
  31.  
  32.        _I_m_p_o_r_t_a_n_t!  The IRIX NetWorker product is very sensitive to
  33.        invalid licenses licenses!  Although backed-up data will not
  34.        be lost if licenses become invalid, configuration
  35.        information can be lost.  Also, your site can be prey to
  36.        this bug even if your licenses are not invalid-if your
  37.        system clock is ever set to an incorrect value, your system
  38.        may believe that your licenses are invalid even if they are
  39.        not.
  40.  
  41.        To protect against the possibility of lost configuration
  42.        information, be sure to save a copy of the files stored in
  43.        the /_n_s_r/_r_e_s directory.  For instance, you could put the
  44.        following in a script called /_u_s_r/_e_t_c/_n_s_r._p_r_o_t_e_c_t:
  45.  
  46.             ####!!!! ////bbbbiiiinnnn////sssshhhh
  47.             iiiiffff [[[[ !!!! ----dddd ////nnnnssssrrrr////rrrreeeessss....bbbbaaaacccckkkkuuuupppp ]]]];;;; tttthhhheeeennnn \\\\
  48.                 mmmmkkkkddddiiiirrrr ----pppp ////nnnnssssrrrr////rrrreeeessss....bbbbaaaacccckkkkuuuupppp;;;; ffffiiii
  49.             ccccdddd ////nnnnssssrrrr....rrrreeeessss
  50.             ccccpppp $$$$iiii ////nnnnssssrrrr////rrrreeeessss....bbbbaaaacccckkkkuuuupppp
  51.  
  52.        Then whenever you want to save your IRIX NetWorker resource
  53.        files (for instance, right after you make important changes
  54.        to them), you would type:
  55.  
  56.             #### ////uuuussssrrrr////eeeettttcccc////nnnnssssrrrr....pppprrrrooootttteeeecccctttt
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        _I_n_c_i_d_e_n_t #_2_2_2_8_0_5
  75.        SSSSuuuummmmmmmmaaaarrrryyyy::::  IRIX NetWorker will allow by default any server to
  76.        access files of any client.
  77.  
  78.        _S_e_c_u_r_i_t_y _W_a_r_n_i_n_g!  IRIX NetWorker as installed by _i_n_s_t on
  79.        NetWorker client systems will allow any NetWorker server
  80.        (Silicon Graphics or other) access to all of the files on
  81.        the client machine.  If you have any internal security
  82.        concerns, insert an additional argument into the invocation
  83.        of the _n_s_r_e_x_e_c_d command in the file /_e_t_c/_i_n_i_t._d/_n_e_t_w_o_r_k_e_r.
  84.        This line usually reads:
  85.  
  86.             ////uuuussssrrrr////eeeettttcccc////nnnnssssrrrreeeexxxxeeeeccccdddd >>>>////ddddeeeevvvv////ccccoooonnnnssssoooolllleeee 2222>>>>&&&&1111
  87.  
  88.        For more secure installations, it should read:
  89.  
  90.             ////uuuussssrrrr////eeeettttcccc////nnnnssssrrrreeeexxxxeeeeccccdddd ----ssss nnnnssssrrrr----sssseeeerrrrvvvveeeerrrr----nnnnaaaammmmeeee >>>>////ddddeeeevvvv////ccccoooonnnnssssoooolllleeee 2222>>>>&&&&1111
  91.  
  92.        You can have as many ----ssss [[[[nnnnaaaammmmeeee]]]] arguments as you want-and
  93.        nnnnssssrrrr----sssseeeerrrrvvvveeeerrrr----nnnnaaaammmmeeee should be the name of your NetWorker server.
  94.        In our case, the line reads:
  95.  
  96.             ////uuuussssrrrr////eeeettttcccc////nnnnssssrrrreeeexxxxeeeeccccdddd ----ssss bbbbiiiittttbbbbuuuucccckkkkeeeetttt....eeeennnnggggrrrr....ssssggggiiii....ccccoooommmm \\\\
  97.                     >>>>////ddddeeeevvvv////ccccoooonnnnssssoooolllleeee 2222>>>>&&&&1111
  98.  
  99.        For more information, see the _n_s_r_e_x_e_c_d(1M) reference page.
  100.  
  101.  
  102.        _I_n_c_i_d_e_n_t #_2_5_4_1_5_9
  103.        SSSSuuuummmmmmmmaaaarrrryyyy::::  IRIX NetWorker will allow the user account
  104.        _o_p_e_r_a_t_o_r access to files of any NetWorker client.
  105.  
  106.        _S_e_c_u_r_i_t_y _W_a_r_n_i_n_g!  A user account named _o_p_e_r_a_t_o_r is able to
  107.        read and/or write any file on a NetWorker client system,
  108.        independent of its UID, using the Backup and Recover
  109.        windows.  NetWorker checks for that account name and
  110.        bypasses some security checks for that particular account.
  111.        This feature supports sites that have true operators that
  112.        mount tapes and recover files for users.  These operators
  113.        are able to write to any file on the system.  This can be
  114.        used to gain _r_o_o_t access.
  115.  
  116.        WWWWoooorrrrkkkkaaaarrrroooouuuunnnndddd::::  Ensure that no NetWorker client system
  117.        (including the NetWorker server system) has an account named
  118.        _o_p_e_r_a_t_o_r.
  119.  
  120.  
  121.        _I_n_c_i_d_e_n_t #_2_2_3_3_9_2
  122.        SSSSuuuummmmmmmmaaaarrrryyyy::::  IRIX NetWorker abandons saveset, then is unable to
  123.        save later on.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        If your IRIX NetWorker client machines' filesystems are too
  141.        large, or the network is not working properly, the timeout
  142.        value in some of the NNNNSSSSRRRR GGGGrrrroooouuuupppp resources may be too small.
  143.  
  144.        As installed, this timeout is set to 30 minutes.  Silicon
  145.        Graphics has found that by increasing it to 60 minutes, all
  146.        but the most intractable examples of this problem are
  147.        solved.  To increase the time, follow the instructions in
  148.        the _I_R_I_X _N_e_t_W_o_r_k_e_r _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e on using the
  149.        nnnnwwwwaaaaddddmmmmiiiinnnn tool.  In nnnnwwwwaaaaddddmmmmiiiinnnn, you will need to select
  150.        _C_u_s_t_o_m_i_z_e->_G_r_o_u_p_s from the menu bar, which will create a
  151.        window.  In that window's menu bar, select _V_i_e_w->_D_e_t_a_i_l_s.
  152.        Now select the name of the problematic group in the upper
  153.        part of the window.  Scroll down in the lower part of the
  154.        window until you see the field iiiinnnnaaaaccccttttiiiivvvviiiittttyyyy ttttiiiimmmmeeeeoooouuuutttt.  Set its
  155.        value to 60.  Then click the _A_p_p_l_y button to commit the
  156.        change.
  157.  
  158.  
  159.        _I_n_c_i_d_e_n_t #_2_3_2_7_4_2
  160.        SSSSuuuummmmmmmmaaaarrrryyyy::::  NetWorker as non-_r_o_o_t fails...
  161.  
  162.        IRIX NetWorker backups and restores may fail when run by a
  163.        user other than _r_o_o_t.
  164.  
  165.        If you see a blank status window when you try to use
  166.        _n_w_b_a_c_k_u_p, and you are running as a user other than _r_o_o_t, try
  167.        running as _r_o_o_t.  The same goes for other IRIX NetWorker
  168.        commands, but this is the most common occurrence of this
  169.        bug.
  170.  
  171.  
  172.        _I_n_c_i_d_e_n_t #_2_5_2_8_0_5
  173.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Adding devices is not working correctly.
  174.  
  175.        Adding devices to IRIX NetWorker does not work if there are
  176.        no devices currently configured.  Also, attempting to change
  177.        the definition of an existing device does not work if there
  178.        is only one device defined.
  179.  
  180.        When adding or changing devices, ensure that you do not
  181.        delete the last one or attempt to change it.  Instead,
  182.        create and configure a new device, then delete the old one.
  183.        If your IRIX NetWorker site is licensed for only one device,
  184.        be sure to delete the old device before rebooting the
  185.        system.
  186.  
  187.  
  188.        _I_n_c_i_d_e_n_t #_2_1_4_3_4_9
  189.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Saves don't follow symbolic links.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        IRIX 5.xxxx and IRIX 6.xxxx use many symbolic links, and IRIX
  207.        NetWorker will not follow them.  For example, an IRIX
  208.        NetWorker site might set up a client system so that the
  209.        /_u_s_r/_m_a_i_l partition is backed up.  Under IRIX 4.xxxx, /_u_s_r/_m_a_i_l
  210.        was a directory in the /_u_s_r partition, but under IRIX 5.xxxx,
  211.        /_u_s_r/_m_a_i_l is a symbolic link to /_v_a_r/_m_a_i_l.  This means that
  212.        in this example, the files in the /_v_a_r/_m_a_i_l directory would
  213.        not be backed up despite their apparent explicit inclusion
  214.        in the requested savesets for the client system.
  215.  
  216.        WWWWoooorrrrkkkkaaaarrrroooouuuunnnnddddssss::::
  217.  
  218.           +o Configure so that as many client machines as possible
  219.             save the special AAAAllllllll saveset.
  220.  
  221.           +o Ensure that all explicitly saved filesystems are really
  222.             filesystems, and not symbolic links.
  223.  
  224.  
  225.        _I_n_c_i_d_e_n_t #_2_2_3_3_8
  226.        SSSSuuuummmmmmmmaaaarrrryyyy::::  NetWorker wants to use _D_e_f_a_u_l_t _P_o_o_l when not
  227.        present or referenced.
  228.  
  229.        _W_a_r_n_i_n_g:  In certain cases, IRIX NetWorker does not select
  230.        the correct PPPPoooooooollll to which to send a client index save.  In
  231.        these cases, the index file backups go to the _D_e_f_a_u_l_t _P_o_o_l.
  232.        This is a problem when sites are not using the _D_e_f_a_u_l_t _P_o_o_l
  233.        at all.  Index save requests can prevent the next backup of
  234.        the same backup GGGGrrrroooouuuupppp.
  235.  
  236.        WWWWoooorrrrkkkkaaaarrrroooouuuunnnnddddssss::::
  237.  
  238.           +o IIIIffff yyyyoooouuuu hhhhaaaavvvveeee aaaa ttttaaaappppeeee rrrroooobbbbooootttt, ensure that at all times at
  239.             least one appendable tape that is labeled _D_e_f_a_u_l_t
  240.             exists in the tape robot.
  241.  
  242.           +o IIIIffff yyyyoooouuuu hhhhaaaavvvveeee aaaa ssssiiiinnnngggglllleeee ttttaaaappppeeee ddddrrrriiiivvvveeee, (not a tape robot),
  243.             use the _D_e_f_a_u_l_t _P_o_o_l for your backups to avoid this
  244.             problem.
  245.  
  246.  
  247.        _N_o _I_n_c_i_d_e_n_t #
  248.        SSSSuuuummmmmmmmaaaarrrryyyy::::  NetWorker client software for old systems doesn't
  249.        look right.
  250.  
  251.        The graphical interfaces supplied for use on IRIX 4.xxxx do not
  252.        correctly use the SGI X11 defaults information to set color
  253.        schemes and fonts.
  254.  
  255.        WWWWoooorrrrkkkkaaaarrrroooouuuunnnndddd::::  Upgrade to IRIX 5.3 or later.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        _N_o _I_n_c_i_d_e_n_t #
  273.        SSSSuuuummmmmmmmaaaarrrryyyy::::  The Exabyte 10i jukebox has a bug which affects
  274.        IRIX NetWorker operations.
  275.  
  276.        The internal firmware in an EXB-10i jukebox has a bug that
  277.        causes it to not respond correctly after the front door to
  278.        the jukebox has been opened and closed.  The next jukebox
  279.        operation after the door has been closed will receive a
  280.        SCSI-bus timeout after 30 seconds and fail.  The next
  281.        jukebox operation after that should work correctly.  The
  282.        suggested workaround is to perform a manual jukebox
  283.        operation (for example, _n_s_r_j_b -_H) immediately afterward if
  284.        the jukebox door has to be opened and closed.  The manual
  285.        operation will receive an error, but the next automatic
  286.        jukebox operation will perform correctly.
  287.  
  288.  
  289.  
  290.        _N_o _I_n_c_i_d_e_n_t #
  291.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Using Hewlett Packard C-1533A 4mm tape drives with
  292.        your IRIX system.
  293.  
  294.        Users who wish to use HP-C1533 4mm tape drives, or robotic
  295.        units which include them (such as the Spectra Logic SL-40000
  296.        jukebox) must insert these lines in their
  297.        /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_s_c_s_i file after the entry for the
  298.        Archive Python drive:
  299.  
  300.             {{{{ DDDDAAAATTTTTTTTAAAAPPPPEEEE,,,, TTTTPPPPDDDDAAAATTTT,,,, 2222,,,, 6666,,,, """"HHHHPPPP"""",,,, """"CCCC1111555555553333AAAA"""",,,, 0000,,,, 0000,,,, {{{{0000,,,, 0000,,,, 0000,,,, 0000}}}},,,,
  301.             MMMMTTTTCCCCAAAANNNN____BBBBSSSSFFFF||||MMMMTTTTCCCCAAAANNNN____BBBBSSSSRRRR||||MMMMTTTTCCCCAAAANNNN____AAAAPPPPPPPPEEEENNNNDDDD||||MMMMTTTTCCCCAAAANNNN____SSSSEEEETTTTMMMMKKKK||||
  302.             MMMMTTTTCCCCAAAANNNN____PPPPAAAARRRRTTTT||||MMMMTTTTCCCCAAAANNNN____PPPPRRRREEEEVVVV||||MMMMTTTTCCCCAAAANNNN____SSSSYYYYNNNNCCCC||||MMMMTTTTCCCCAAAANNNN____SSSSPPPPEEEEOOOODDDD||||
  303.             MMMMTTTTCCCCAAAANNNN____CCCCHHHHKKKKRRRRDDDDYYYY||||MMMMTTTTCCCCAAAANNNN____VVVVAAAARRRR||||MMMMTTTTCCCCAAAANNNN____SSSSEEEETTTTSSSSZZZZ||||MMMMTTTTCCCCAAAANNNN____SSSSIIIILLLLIIII||||
  304.             MMMMTTTTCCCCAAAANNNN____SSSSEEEEEEEEKKKK||||MMMMTTTTCCCCAAAANNNN____CCCCHHHHTTTTYYYYPPPPEEEEAAAANNNNYYYY,,,,
  305.             44440000,,,, 8888****66660000,,,, 4444****66660000,,,, 5555****66660000,,,, 555511112222,,,, 555511112222****111122228888 }}}},,,,
  306.  
  307.        After that, rebuild the kernel and reboot:
  308.  
  309.             #### aaaauuuuttttooooccccoooonnnnffffiiiigggg ----ffff
  310.             #### rrrreeeebbbbooooooootttt
  311.  
  312.        The switch settings on HP-C1533 drives as set from the
  313.        factory will not work with your Silicon Graphics system.
  314.        You may find the bank of eight switches on the bottom of the
  315.        drive.  The set of switch settings SGI recommends for these
  316.        drives is switches 1, 2, and 5 on, all others off.
  317.  
  318.  
  319.        _N_o _I_n_c_i_d_e_n_t #
  320.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Using Hewlett-Packard C-1553A 4mm tape robotic
  321.        units with your IRIX system.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        Users who wish to use HP-C1553 robotic units must insert
  339.        these lines in their /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_s_c_s_i file after
  340.        the entry for the Archive Python drive:
  341.  
  342.             {{{{ DDDDAAAATTTTTTTTAAAAPPPPEEEE,,,, TTTTPPPPDDDDAAAATTTT,,,, 2222,,,, 6666,,,, """"HHHHPPPP"""",,,, """"CCCC1111555555553333AAAA"""",,,, 0000,,,, 0000,,,, {{{{0000,,,, 0000,,,, 0000,,,, 0000}}}},,,,
  343.             MMMMTTTTCCCCAAAANNNN____BBBBSSSSFFFF||||MMMMTTTTCCCCAAAANNNN____BBBBSSSSRRRR||||MMMMTTTTCCCCAAAANNNN____AAAAPPPPPPPPEEEENNNNDDDD||||MMMMTTTTCCCCAAAANNNN____SSSSEEEETTTTMMMMKKKK||||
  344.             MMMMTTTTCCCCAAAANNNN____PPPPAAAARRRRTTTT||||MMMMTTTTCCCCAAAANNNN____PPPPRRRREEEEVVVV||||MMMMTTTTCCCCAAAANNNN____SSSSYYYYNNNNCCCC||||MMMMTTTTCCCCAAAANNNN____SSSSPPPPEEEEOOOODDDD||||
  345.             MMMMTTTTCCCCAAAANNNN____CCCCHHHHKKKKRRRRDDDDYYYY||||MMMMTTTTCCCCAAAANNNN____VVVVAAAARRRR||||MMMMTTTTCCCCAAAANNNN____SSSSEEEETTTTSSSSZZZZ||||MMMMTTTTCCCCAAAANNNN____SSSSIIIILLLLIIII||||
  346.             MMMMTTTTCCCCAAAANNNN____SSSSEEEEEEEEKKKK||||MMMMTTTTCCCCAAAANNNN____CCCCHHHHTTTTYYYYPPPPEEEEAAAANNNNYYYY,,,,
  347.             44440000,,,, 8888****66660000,,,, 4444****66660000,,,, 5555****66660000,,,, 555511112222,,,, 555511112222****111122228888 }}}},,,,
  348.  
  349.        After that, rebuild the kernel and reboot:
  350.  
  351.             #### aaaauuuuttttooooccccoooonnnnffffiiiigggg ----ffff
  352.             #### rrrreeeebbbbooooooootttt
  353.  
  354.        The switch settings on HP-C1553 robotic units as set from
  355.        the factory will not work with your Silicon Graphics system.
  356.        You may find the bank of eight option switches on the bottom
  357.        of the unit.  The switch settings SGI recommends for these
  358.        drives is switches 1, 2, and 5 on, all others off.  There
  359.        are no user-settable switches on the unit which control
  360.        robotic options.
  361.  
  362.  
  363.  
  364.        _N_o _I_n_c_i_d_e_n_t #
  365.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Do not use the top slot in Exabyte 210 jukebox.
  366.  
  367.        This slot is ignored by NetWorker, so do not put a data tape
  368.        in this slot.
  369.  
  370.  
  371.        _N_o _I_n_c_i_d_e_n_t #
  372.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Summary: Do not embed special characters in
  373.        schedule names.
  374.  
  375.        IRIX NetWorker enforces restrictions on characters in
  376.        schedule names to alphanumeric characters and '-'.  If an
  377.        existing NetWorker server that uses other than these
  378.        characters in schedule names is upgraded to IRIX NetWorker,
  379.        shedule names will be changed to replace these characters,
  380.        and client configurations that used these schedules will be
  381.        changed to use the Default schedule.
  382.  
  383.        The simplest solution is to rename the schedule before
  384.        upgrading.  To do this, stop NetWorker using
  385.        "/etc/init.d/networker stop".  Replace the schedule name
  386.        every where it appears in the file /nsr/res/nsr.res with a
  387.        new name that does not use special characters.  Then upgrade
  388.        to IRIX NetWorker.  Otherwise, the schedule must be re-
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.        created under IRIX NetWorker and the server client
  405.        configurations changed to use the new schedule.
  406.  
  407.  
  408.        _N_o _I_n_c_i_d_e_n_t #
  409.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Deleting and re-adding jukebox destroys volume
  410.        label and slot information.
  411.  
  412.        If you delete a jukebox under nwadmin, it removes all the
  413.        state and configuration associated with this jukebox,
  414.        including volume labels and slot assignments.  Do not delete
  415.        a jukebox unless removing it permanently from the NetWorker
  416.        server.
  417.  
  418.  
  419.        _N_o _I_n_c_i_d_e_n_t #
  420.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Server per-client index is limited to 4 GB
  421.        (without PerformancePak) or 16 GB (with PerformancePak).
  422.  
  423.        The size of the IRIX NetWorker 4.2.x client index in the
  424.        server directory ////nnnnssssrrrr////iiiinnnnddddeeeexxxx is limited to either 4 GB or 16
  425.        GB.  Once this limit is reached, NetWorker notifies the
  426.        system administrator and ceases to update the online index
  427.        for this client during backups.
  428.  
  429.        Monitor index sizes in ////nnnnssssrrrr////iiiinnnnddddeeeexxxx and NetWorker
  430.        notifications, and set browse policies to prevent per-client
  431.        indexes from reaching 4 GB (or 16 GB if PerformancePak is
  432.        installed).
  433.  
  434.  
  435.  
  436.        _N_o _I_n_c_i_d_e_n_t #
  437.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Licenses must be consistent; inconsistent licenses
  438.        can cause incorrect behavior of the NetWorker server.
  439.  
  440.        Please be sure that your licenses are consistent. For
  441.        example, there are three different base NetWorker licenses:
  442.        the demo version, the Network Edition, and the Server
  443.        Edition. (And there is also the NetWorker Edition upgrade
  444.        from Server Edition.)  Obviously, you only need one of
  445.        these. But less obviously, you must not have more than one
  446.        of these.
  447.  
  448.        It is a common assumption that the NetWorker server would
  449.        require the Server Edition license, but this is usually
  450.        incorrect. The Server Edition permits backups of only the
  451.        server itself; most installations will use the Network
  452.        Edition which allows multiple clients connect to the
  453.        NetWorker server across the LAN.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                   - 8 -
  467.  
  468.  
  469.  
  470.        If you have more than one jukebox, of different capacities,
  471.        this is how to apply the licenses. First, add the licenses
  472.        for all parts of NetWorker other than the jukeboxes to your
  473.        license.dat file. Then, run nnnnssssrrrrccccaaaapppp ----vvvv.
  474.  
  475.        Then, add only the smallest jukebox license to your
  476.        lllliiiicccceeeennnnsssseeee....ddddaaaatttt file, and run nnnnssssrrrrccccaaaapppp again. This will bind the
  477.        small jukebox license to your smallest jukebox.
  478.  
  479.        Finally, add the larger jukebox license to your lllliiiicccceeeennnnsssseeee....ddddaaaatttt
  480.        file, and again run nnnnssssrrrrccccaaaapppp.  Repeat these last two steps for
  481.        each additional jukebox license, one at a time, in order
  482.        from smallest to largest.
  483.  
  484.  
  485.  
  486.        _N_o _I_n_c_i_d_e_n_t #
  487.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Recovery of the NetWorker server after a crash can
  488.        be time-consuming.
  489.  
  490.        If NetWorker's operations should be suddenly interrupted, as
  491.        by a crash or other malfunction of the NetWorker server, it
  492.        is possible that NetWorker's indexes may become corrupted.
  493.        In this case, NetWorker must perform a consistency check of
  494.        the indexes, and possibly recover them using any of a
  495.        variety of techniques, depending on the severity of the
  496.        damage. The time required depends on the speed of your
  497.        CPU/disk subsystem, overall system loading, the overall size
  498.        of the index, the actual data stored in the index, as well
  499.        as possibly other factors.  Following are some suggestions
  500.        for minimizing the time that the NetWorker server requires
  501.        to restart after a crash.
  502.  
  503.        The NetWorker server stores its file indexes in
  504.        ////nnnnssssrrrr////iiiinnnnddddeeeexxxx////{{{{nnnnaaaammmmeeee----ooooffff----cccclllliiiieeeennnntttt}}}}////ddddbbbb, and when this file becomes
  505.        corrupted, NetWorker must rebuild parts of it. NetWorker
  506.        will do this automatically when it restarts, or the system
  507.        administrator can do this manually using nnnnssssrrrrcccckkkk ----FFFF.
  508.  
  509.        Some general rules that apply here are useful to keep in
  510.        mind.
  511.  
  512.           +o You must always maintain adequate free space under
  513.             ////nnnnssssrrrr.  The ////nnnnssssrrrr hierarchy must nnnneeeevvvveeeerrrr be allowed to run
  514.             out of space; otherwise you risk index corruption. From
  515.             a practical standpoint, this means putting ////nnnnssssrrrr in its
  516.             own filesystem.
  517.  
  518.           +o If the NetWorker server crashes (usually because the
  519.             entire machine crashes), then upon restarting the
  520.             system, you must allow NetWorker to completely process
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                   - 9 -
  533.  
  534.  
  535.  
  536.             the indexes and verify their validity. Do not under any
  537.             circumstances terminate any NetWorker processes while
  538.             index processing is underway. (You can recognize this
  539.             state by noting the CPU time used by nnnnssssrrrriiiinnnnddddeeeexxxxdddd.)
  540.  
  541.           +o While NetWorker is busy in this state of index
  542.             recovery, then all other NetWorker operations will be
  543.             locked out. This includes both saves and recoveries.
  544.             DDDDoooo nnnnooootttt attempt to terminate any NetWorker processes in
  545.             this situation; you'll just be right back where you
  546.             started if you do. You must wait for the index recovery
  547.             operation to complete.
  548.  
  549.           +o Do whatever you can to minimize the risk of abrupt
  550.             NetWorker shutdown (crash). For instance, you should do
  551.             whatever is necessary to ensure that ////nnnnssssrrrr never runs
  552.             out of space. Using appropriate RAID technology to
  553.             protect the ////nnnnssssrrrr hierarchy from corruption caused by
  554.             disk failure is also recommended.
  555.  
  556.           +o Monitor the sizes of your indexes, because larger
  557.             indexes will take significantly longer to validate
  558.             after a NetWorker crash. You should establish an
  559.             appropriate compromise between the recovery time and
  560.             index size.
  561.  
  562.        As the NetWorker server restarts, each client index is
  563.        processed in turn. For the fastest possible recovery time of
  564.        the NetWorker server, the system administrator could process
  565.        the indexes in parallel, using the following guidelines.
  566.        (Note that this procedure is entirely optional; if you don't
  567.        do this, then NetWorker will perform the equivalent
  568.        operation, iterating serially over all the client indexes,
  569.        as described above.)
  570.  
  571.  
  572.           +o You must not allow the NetWorker daemons to start when
  573.             the system comes up after the crash.
  574.  
  575.           +o Process each client index with nnnnssssrrrrcccckkkk ----FFFF {{{{cccclllliiiieeeennnntttt----nnnnaaaammmmeeee}}}}.
  576.             You can run as many nnnnssssrrrrcccckkkk ----FFFF {{{{cccclllliiiieeeennnntttt----nnnnaaaammmmeeee}}}} processes as
  577.             you like, each one operating on a different client
  578.             index; they will all run in parallel.
  579.  
  580.           +o The free disk space requirement under ////nnnnssssrrrr
  581.              will be highest using this approach. The rule of thumb
  582.             is that you must have free space under ////nnnnssssrrrr equal to
  583.             the combined sizes of all client indexes that are being
  584.             processed simultaneously by nnnnssssrrrrcccckkkk, plus a 30% cushion.
  585.             Of course, this could add up to a substantial
  586.             requirement for free disk space, but it is the solution
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                   - 10 -
  599.  
  600.  
  601.  
  602.             that offers the fastest possible recovery time.
  603.  
  604.           +o Once all client indexes have been processed by nnnnssssrrrrcccckkkk,
  605.             then the NetWorker daemons can be restarted for normal
  606.             operations.
  607.  
  608.           +o It is probable that not all client indexes will need
  609.             recovery. The nnnnssssrrrrcccckkkk process will notice which ones need
  610.             recovery; for indexes which are not corrupted, nnnnssssrrrrcccckkkk
  611.             will simply terminate.
  612.  
  613.           +o BBBBeeeeffffoooorrrreeee running nnnnssssrrrrcccckkkk manually, the system administrator
  614.             mmmmuuuusssstttt ensure that if nnnnssssrrrrcccckkkk is interrupted (for instance,
  615.             by a system crash), that the system won't automatically
  616.             restart NetWorker's daemons until after the index
  617.             recovery process is fully complete.
  618.  
  619.  
  620.        _N_o _I_n_c_i_d_e_n_t #
  621.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Index extent too small error message.
  622.  
  623.        If you should see an error message of this form:
  624.  
  625.        nnnnssssrrrrcccckkkk:::: WWWWAAAARRRRNNNNIIIINNNNGGGG:::: iiiinnnnddddeeeexxxx ////iiiinnnnddddeeeexxxx////nnnnssssrrrr////iiiinnnnddddeeeexxxx////<<<<cccclllliiiieeeennnntttt>>>>////ddddbbbb eeeexxxxtttteeeennnntttt #### ttttoooooooo ssssmmmmaaaallllllll ((((8888111199991111))))
  626.  
  627.        it means that this original index conversion process was not
  628.        performed correctly. The solution is to shut down NetWorker,
  629.        and then use nnnnssssrrrrcccckkkk ----FFFF on the affected client.
  630.  
  631.  
  632.        _N_o _I_n_c_i_d_e_n_t #
  633.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Issues with machine alias names in NetWorker 4.2.5
  634.        or 4.2.9.
  635.  
  636.        NetWorker 4.2.x is much fussier than 4.1.3 with respect to
  637.        the aliases you use for your machine names. In 4.2.x you
  638.        must use exact (fully qualified) alias names. If you don't
  639.        do this, you'll typically see messages of the form "usr root
  640.        on machine fred is not on fred.sgi.com's access list". This
  641.        message is generated by authentication logic that was
  642.        introduced in 4.2.x, which is completely different than the
  643.        logic used by 4.1.x.
  644.  
  645.        With NetWorker 4.2.x, a machine name (as it known to
  646.        Networker) MUST be on the alias list. For example, if
  647.        Networker knows a machine by the name "fred" and in the
  648.        alias list there is only one alias "fred.sgi.com", the save
  649.        will fail and it will issue something like "user root on
  650.        machine fred is not on fred.sgi.com's access list". For this
  651.        to work, the aliases must match, and "fred" is not a match
  652.        for "fred.sgi.com".
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                   - 11 -
  665.  
  666.  
  667.  
  668.        When you create client entries using NetWorker 4.2.x, it
  669.        automatically creates both long and short (i.e., FQDN and
  670.        canonical) hostnames. So this issue should never be a
  671.        concern unless you have changed things around, or have
  672.        upgraded from a previous version of IRIX NetWorker.
  673.  
  674.        Of course, another approach is to ensure that the correct
  675.        clients mentioned in the appropriate remotes access list.
  676.  
  677.  
  678.  
  679.        _N_o _I_n_c_i_d_e_n_t #
  680.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Clients can't have similar names. (One is a
  681.        substring of the other.)
  682.  
  683.        NetWorker has trouble with clients that have similar names.
  684.        Specifically, if you have one client whose name is a
  685.        substring of the other client, this issue can arise. For
  686.        example, your clients might be named fred and fred2. We're
  687.        working to provide a solution for this at a future date.
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.